home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / 1edit101.zip / 1EDIT.DOC next >
Text File  |  1990-05-06  |  33KB  |  1,123 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                       ┌─────────────────────────────────┐
  18.                       │ ┌─────────────────────────────┐ │
  19.                       │ │      -*-  1-EDIT  -*-       │ │
  20.                       │ └─────────────────────────────┘ │
  21.                       └─────────────────────────────────┘
  22.  
  23.  
  24.                                 Version: 1.01
  25.  
  26.  
  27.                                       by
  28.  
  29.  
  30.                                   Bob Ransom
  31.  
  32.  
  33.  
  34.                               Copyright (c) 1990
  35.                              All Rights Reserved
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                    ┌───────────────────────────────────────┐
  76.                    │          TABLE OF CONTENTS            │
  77.                    └───────────────────────────────────────┘
  78.  
  79.  
  80.  
  81.           What Is 1-EDIT? .................................  2
  82.           Acknowledgements ................................  3
  83.           Shareware & Warranty ............................  4
  84.           FOSSILS, ANSI.SYS & Other Requirements ..........  5
  85.               LOCAL.DEF File ..............................  5
  86.               Locked COM Ports ............................  6
  87.           Command Line Syntax .............................  7
  88.               Colors ......................................  7
  89.               Drop To DOS Security ........................  7
  90.           Getting Started .................................  7
  91.               Setting Up 1-EDIT Within QuickBBS ...........  7
  92.           Drop To DOS .....................................  9
  93.               Local Drop To DOS ...........................  9
  94.               Remote Drop To DOS ..........................  9
  95.           The MENU Editor ................................. 11
  96.           The USER Editor ................................. 12
  97.               Mass User Updates ........................... 12
  98.           Registering 1-EDIT .............................. 14
  99.               Keys ........................................ 14
  100.               Installing Keys ............................. 14
  101.           Beta Sites ...................................... 15
  102.           Final Notes ..................................... 16
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.           1-EDIT v1.01                                  Page 1
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.                    ┌───────────────────────────────────────┐
  143.                    │           WHAT IS 1-EDIT?             │
  144.                    └───────────────────────────────────────┘
  145.  
  146.  
  147.  
  148.           1-EDIT is a combined User Editor and Menu Editor for
  149.           QuickBBS systems designed to work reliably from remote.
  150.           Features include:
  151.  
  152.                     - Built-in FOSSIL routines for guaranteed remote
  153.                     performance.
  154.  
  155.                     - Full carrier detection which returns to
  156.                     QuickBBS when carrier is dropped.
  157.  
  158.                     - Automatic high speed performance with locked
  159.                     ports at up to 38,400 baud (and possibly
  160.                     higher).
  161.  
  162.                     - Status line showing user name, baud and modem
  163.                     settings, and time remaining.
  164.  
  165.                     - Drop to DOS functions while online.
  166.  
  167.                     - User-definable colors.
  168.  
  169.                     - Full editing capabilities of nearly all fields
  170.                     in the USERS.BBS file.
  171.  
  172.                     - Mass flag updating of user records.
  173.  
  174.                     - Mass "High Message Read" updating of all user
  175.                     records.
  176.  
  177.                     - Full menu editing capabilities including
  178.                     adding and deleting menus, renaming menus,
  179.                     copying menus, plus direct editing of each line
  180.                     of the menu record.  Direct editing allows you
  181.                     to insert, delete, change, and list the lines of
  182.                     the edited menu, plus full menu simulation.
  183.  
  184.                     - Small file size: the program is only around
  185.                     67K and will run in about 82K of memory.  This
  186.                     allows 1-EDIT to run easily from a Type 7 shell.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.           1-EDIT v1.01                                  Page 2
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.                    ┌───────────────────────────────────────┐
  208.                    │           ACKNOWLEDGEMENTS            │
  209.                    └───────────────────────────────────────┘
  210.  
  211.  
  212.  
  213.           A big hearty "Thank You" to all those trusting soles who
  214.           opened up their machines and systems files to me to help
  215.           beta test this software.  To make sure it works, a program
  216.           needs to be tested on as many setups as possible and the
  217.           owners of those systems must be willing to really give the
  218.           program a workout.  These guys have.  Thanks to Barron
  219.           Featherston, Bob Holiday, Chris Lamprecht, Jim Roe, Jim
  220.           Westbrook, Bill Chambers, George Vandervort, and John
  221.           Parlin.
  222.  
  223.           Additional thanks go to John Parlin for creating such a
  224.           great FOSSIL interface for Turbo Pascal programmers.  His
  225.           JPDOOR makes programming doors a breeze.  Some background
  226.           is warranted here:  I began this program well over a year
  227.           ago, using FOSSIL and door routines that I wrote myself.
  228.           My package was decent and workable -- not great, mind you,
  229.           but not bad.  However, it never did all the things I
  230.           wanted it to do so development was put on hold for quite
  231.           a while.  Then I took a look at John's package, yelled
  232.           "Eureka!" loudly, promptly ditched my door units and
  233.           replaced them with his, and began the final work on
  234.           1-EDIT.  If you're interested in writing doors of your own
  235.           in TP, definitely take a look John's package. Registration
  236.           for it is only $15 and it is *very* complete, including
  237.           .TPU's for TP 4.0, TP 5.0, and TP 5.5.
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.           1-EDIT v1.01                                  Page 3
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.                    ┌───────────────────────────────────────┐
  276.                    │     1-EDIT: SHAREWARE & WARRANTY      │
  277.                    └───────────────────────────────────────┘
  278.  
  279.  
  280.  
  281.           Here comes the dull but necessary stuff:
  282.  
  283.           SHAREWARE INFO
  284.  
  285.           This program is released to the public as shareware.  This
  286.           means try it and if you like it, you must register it
  287.           within a reasonable amount of time.  The program is not
  288.           freeware nor public domain; it is copyrighted material
  289.           with all rights reserved.  You are granted only a limited
  290.           license to test this software.  You may not make any
  291.           changes to it whatsoever.
  292.  
  293.           You may copy 1-EDIT and transfer it to others provided you
  294.           follow these brief rules:
  295.  
  296.           1- You may not change the program, its archive, or its
  297.           documentation in anyway without express written consent
  298.           from me, the author.
  299.  
  300.           2- You may not sell the program.  This program may be
  301.           distributed on pay systems, but not on a
  302.           "fee-per-download" basis.
  303.  
  304.           3- You may not distribute this product with other products
  305.           without express written consent from me.
  306.  
  307.           Registration of 1-EDIT is a cheap $10 and covers you for
  308.           all future releases of the program.  More information on
  309.           registering is included later in this document.
  310.  
  311.  
  312.           WARRANTY
  313.  
  314.           No warranty of any kind, covering either hardware or
  315.           software damage, is neither expressed nor implied.  Use
  316.           this program at your own risk.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.           1-EDIT v1.01                                  Page 4
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.               ┌─────────────────────────────────────────────────┐
  340.               │   FOSSILS, ANSI.SYS, and OTHER REQUIREMENTS     │
  341.               └─────────────────────────────────────────────────┘
  342.  
  343.  
  344.  
  345.           There are a few things you should know before attempting
  346.           to boot 1-EDIT for the first time:
  347.  
  348.  
  349.           FOSSIL Driver
  350.  
  351.           1-EDIT requires a FOSSIL driver to be installed and active
  352.           at all times.  This shouldn't prove to be much of a
  353.           hindrance since 1-EDIT was designed for remote use.  If
  354.           you are editing strictly from the local console, QUFE and
  355.           Menu Master do the same job with more bells and whistles,
  356.           and they *don't* require a FOSSIL.  (However, they're not
  357.           meant for remote use, either.)  1-Edit has been tested
  358.           with both the X00 driver and the BNU driver.
  359.  
  360.  
  361.           ANSI Graphics
  362.  
  363.           1-EDIT requires all users of the program to have the
  364.           ANSI.SYS driver installed - both on the BBS and remote
  365.           caller's systems.  99.9% of sysops do have it installed so
  366.           this shouldn't be a problem.  If you're unfamiliar with
  367.           ANSI.SYS, see your DOS manual.  ANSI.SYS is included with
  368.           all versions of DOS.
  369.  
  370.  
  371.           DORINFO1.DEF & LOCAL.DEF
  372.  
  373.           1-EDIT requires a DORINFO1.DEF file to be present when
  374.           starting.  First, some background on this file and how to
  375.           get around the necessity of having it:  When QuickBBS
  376.           shells to another program, either through a menu Type 7
  377.           exit or a menu Type 15 exit, it creates two files on your
  378.           disk: DORINFO1.DEF and EXITINFO.BBS.  Both contain
  379.           information for the child program to use in determining
  380.           the user's name, baud rate and modem settings, graphic
  381.           settings, etc.  When you return to QuickBBS from the
  382.           shell, QuickBBS deletes both of these files.  That's why
  383.           you can never find them on your disk -- they're already
  384.           gone.
  385.  
  386.           Because 1-Edit requires DORINFO1.DEF and because a copy
  387.           won't always be available, I've made the program search
  388.           for a second file called LOCAL.DEF.  LOCAL.DEF is nothing
  389.           but a copy of DORINFO1.DEF which should stay in your main
  390.           1-EDIT v1.01                                  Page 5
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.           QuickBBS directory.  When run, 1-EDIT will first search
  406.           for the DORINFO1.DEF file.  If it's not found, it will
  407.           then try to find the LOCAL.DEF file.  If that's not found,
  408.           the program aborts.  If it *is* found (remember, you're
  409.           supposed to leave it on your disk so it should be there),
  410.           1-EDIT will copy it over to DORINFO1.DEF.  When you quit
  411.           1-EDIT, the DORINFO1.DEF file will be deleted.
  412.  
  413.           A copy of LOCAL.DEF is included in the 1-EDIT archive
  414.           which you may edit to reflect your name and system name.
  415.           Here's what it looks like with my comments in braces { }:
  416.  
  417.           -------------------------------------------------------
  418.           THE CREATIVE CONNECTION-SOUTHFIELD, MI-(313)559-9039
  419.           BOB                    {Sysop first name}
  420.           RANSOM                 {Sysop last name}
  421.           COM0                   {Don't edit this!}
  422.           0 Baud,N,8,1           {No need to edit this}
  423.           0                      {This does nothing - just a zero}
  424.           BOB                    {User first name}
  425.           RANSOM                 {User last name}
  426.           LATHRUP VILLAGE, MI    {No need to edit; not used}
  427.           1                      {1=Graphics.  Don't edit}
  428.           32000                  {User security level}
  429.           235                    {User time remaining}
  430.           -------------------------------------------------------
  431.  
  432.           Feel free to edit your copy of LOCAL.DEF to reflect the
  433.           proper sysop names and user names.  The COM port setting
  434.           MUST remain as COM0 -- this indicates a local connect.
  435.           Changing the security and time remaining is up to you.
  436.           Time remaining is not counted while in local.  After
  437.           editing, place the LOCAL.DEF in your main QuickBBS
  438.           directory and leave it there.
  439.  
  440.  
  441.           Directories
  442.  
  443.           1-EDIT must be run from your main QuickBBS directory,
  444.           where USERS.BBS and CONFIG.BBS are located.
  445.  
  446.           Okay, that takes care of the requirements.  Now, you've
  447.           unZIPped the 1-EDIT file and put it and the edited
  448.           LOCAL.DEF into your main QuickBBS directory.  Now you're
  449.           almost ready to get started.
  450.  
  451.  
  452.           Locked COM Ports
  453.  
  454.           Locked COM ports are supported automatically by 1-EDIT.
  455.           There is no need to use DorSpeed, SetSpeed, etc.  1-EDIT
  456.           1-EDIT v1.01                                  Page 6
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.           has been successfully tested at speeds up to 38,400 baud.
  472.                    ┌───────────────────────────────────────┐
  473.                    │         COMMAND LINE SYNTAX           │
  474.                    └───────────────────────────────────────┘
  475.  
  476.  
  477.  
  478.           1-EDIT allows you to customize it somewhat via the command
  479.           line.  These parameters may be included if you wish
  480.           (they're optional):
  481.  
  482.           -Fxx     Sets foreground color to xx.  xx must be 0-7.
  483.                    Default color is cyan (#3).
  484.  
  485.           -Hxx     Sets the highlight color to xx.  xx must be 0-15.
  486.                    Default highlight color is bright yellow (#14).
  487.  
  488.           -Sxxxxx  Sets the minimum security level for the Drop to
  489.                    DOS feature to xxxxx.  xxxxx must be 0-32000.
  490.                    Default is 32000.  More on this feature later.
  491.  
  492.           -B       Tells 1-EDIT to make a backup of the USERS.BBS
  493.                    file before editing it.  Default is to NOT make
  494.                    a backup.  1-EDIT has been tested to death and
  495.                    works fine.  However, if you often are plagued
  496.                    with noisy phone lines, it might not be a bad
  497.                    idea to use this feature.
  498.  
  499.           ?        Brings up very short help screen describing
  500.                    command line parameters.
  501.  
  502.           None of these parameters are required; use any, all, or
  503.           none of them as you choose.  The command line may be in
  504.           upper case or lower; it doesn't matter.
  505.  
  506.  
  507.  
  508.                    ┌───────────────────────────────────────┐
  509.                    │           GETTING STARTED             │
  510.                    └───────────────────────────────────────┘
  511.  
  512.  
  513.  
  514.           With that boring stuff out of the way, we'll get on to the
  515.           meat of the program.  I'm not going to bother taking you
  516.           through each and every option in the editors -- most
  517.           commands are pretty self-explanatory, so I'll just touch
  518.           on most of it and highlight oddities, etc.  Any sysop that
  519.           has gotten a QuickBBS system up and running shouldn't have
  520.           any problems.
  521.  
  522.           1-EDIT v1.01                                  Page 7
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.           Setting Up 1-EDIT Within QuickBBS
  539.  
  540.           1-EDIT has been tested under both a QuickBBS Type 7 exit
  541.           and a Type 15 exit; either setup will work just fine.
  542.           However, because of its small size, 1-EDIT is probably
  543.           best run as a Type 7 except on systems with very tight
  544.           memory constraints (i.e. Desqview and DoubleDOS systems).
  545.           For Desqview/DoubleDOS users: As best as I can tell,
  546.           1-EDIT runs in about 82K of memory.
  547.  
  548.           Here's a sample of how a Type 7 setup would look from
  549.           within Menuedit:
  550.           ---------------------------------------------------------
  551.           Adding Entry
  552.  
  553.                    1         2         3         4         5
  554.           1234567890123456789012345678901234567890123456789012345678
  555.           <^1^> ............  Run 1-Edit User/Menu Editor░░░░░░░░░░░
  556.  
  557.           Optional Data:
  558.           \command.com /c 1EDIT.EXE -F7 -H15 -S100░░░░░░░░░░░░░░░
  559.  
  560.           Type...........: 7
  561.           Security.......: 100
  562.           Key............: 1
  563.           Foreground.....: 3
  564.           Background.....: 0
  565.           A Flags........: --------
  566.           B Flags........: --------
  567.           C Flags........: --------
  568.           D Flags........: --------
  569.  
  570.           ---------------------------------------------------------
  571.  
  572.           As mentioned earlier, the -F, -H, and -S command line
  573.           parameters are completely optional; leave them off if
  574.           you're happy with the defaults.
  575.  
  576.  
  577.           Actual Startup
  578.  
  579.           When you first start 1-EDIT, it will check to see that a
  580.           FOSSIL is present.  If not, the program aborts.  From
  581.           there is begins its search for DORINFO1.DEF, using
  582.           LOCAL.DEF if necessary.  Some values are initialized, then
  583.           an opening screen pops up.  If you haven't registered your
  584.           program yet, the program will ring the bell then pause for
  585.           4 seconds to <ahem> encourage registration.  After the
  586.           pause you'll be prompted to "Press [ENTER] to continue:".
  587.           Press enter and  you'll get the main menu.
  588.           1-EDIT v1.01                                  Page 8
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.           From the main menu you may choose to edit user files, menu
  605.           files or drop to DOS.  At this point, registered versions
  606.           of 1-EDIT will show a status line on the local console
  607.           detailing who's online, baud and modem settings, and time
  608.           remaining.  Unregistered versions show only the line
  609.           "Unregistered Evaluation Copy."
  610.  
  611.           A side note that applies here and throughout most of the
  612.           program: Pressing [ENTER] or entering a question mark will
  613.           redraw the screen.  This is really only useful in times of
  614.           high line noise, but it's nice to have available when you
  615.           need it.
  616.  
  617.  
  618.  
  619.                    ┌───────────────────────────────────────┐
  620.                    │         DROP TO DOS FEATURE           │
  621.                    └───────────────────────────────────────┘
  622.  
  623.  
  624.  
  625.           This feature can be both very useful and very dangerous,
  626.           so please read this section carefully.  Before attempting
  627.           to use the Drop to DOS feature, be sure your CONFIG.SYS
  628.           file sets COMSPEC=<path to COMMAND.COM>.  1-EDIT uses that
  629.           DOS environment to tell it where to find COMMAND.COM.  For
  630.           more info on CONFIG.SYS files and setting COMSPEC, see
  631.           your DOS manual.  If you wish to test whether COMSPEC= is
  632.           set or not, type SET at any DOS prompt.  This will cause
  633.           DOS to display your environment settings
  634.  
  635.           When displaying the main menu, 1-EDIT checks the users
  636.           security level (set in DORINFO1.DEF) against the security
  637.           level set on the command line (or the default, 32000).  If
  638.           the user's level equals or exceeds that level, the Drop to
  639.           DOS function appears on the main menu.  If the user's
  640.           security level is *less* than the specified level, the
  641.           option doesn't even show up as an option.  This allows you
  642.           to have co-sysops be able to edit your BBS files without
  643.           actually cutting them loose in DOS.
  644.  
  645.  
  646.           LOCAL DROP TO DOS
  647.  
  648.           Drop to DOS works two different ways, depending on whether
  649.           you're calling locally or remotely.  When in local mode,
  650.           the drop to DOS is just a very simple shell.  You hit "D"
  651.           and you get the familiar flashing cursor.  (What actually
  652.           happens is a second copy of COMMAND.COM is loaded.)  You
  653.           may run whatever files you need to run from here.  When
  654.           1-EDIT v1.01                                  Page 9
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.           ready to return to 1-EDIT, simply type EXIT.
  670.  
  671.  
  672.           REMOTE DROP TO DOS
  673.  
  674.           Things become a bit more complicated when dropping to DOS
  675.           remotely because 1-EDIT goes on hold during the shell.
  676.           This is similar to Type 7 and Type 15 exits out of
  677.           QuickBBS -- when you shell out, you loose QuickBBS's
  678.           ability to send things through the modem, watch carrier
  679.           and time remaining, etc.  The same happens when you shell
  680.           out of 1-EDIT -- whatever you shell to must take over all
  681.           modem functions including FOSSIL interface, carrier
  682.           detect, etc.  Because of this, a warning pops up when
  683.           executing the shell reminding you not to go and try to
  684.           load WordPerfect or something that has no modem routines.
  685.  
  686.           When you do execute the shell, you're prompted to enter a
  687.           filename to execute.  Leave this field blank and 1-EDIT
  688.           will return to the main menu.  If you do execute a program
  689.           or batch file, BE SURE TO INCLUDE THE FILE EXTENSION WITH
  690.           THE FILENAME (i.e. ".EXE", ".COM", ".BAT").  You may also
  691.           include as many command line parameters as you can fit
  692.           into the field.  These parameters will be passed on to the
  693.           child program.  When you exit the child program, you'll be
  694.           returned automatically to 1-EDIT's main menu.
  695.  
  696.           A sample batch file called DOSSHELL.BAT is included in the
  697.           archive for you to look over.  It details how you can set
  698.           up a true drop to DOS from 1-EDIT using CTTY COMx or (a
  699.           better method using Gateway) CTTY GATEx.  If you decide to
  700.           try this batch file, be sure you pass your baud rate to it
  701.           on the command line: DOSSHELL.BAT 2400 (or whatever rate
  702.           you're using).  Also, be sure to test this batch file
  703.           carefully before relying on it!
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.           1-EDIT v1.01                                  Page 10
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                    ┌───────────────────────────────────────┐
  736.                    │           THE MENU EDITOR             │
  737.                    └───────────────────────────────────────┘
  738.  
  739.  
  740.  
  741.           Those of you familiar with Adam Hudson's original Menuedit
  742.           will feel right at home here.  When you first choose the
  743.           menu editor from the main menu, you'll be presented with a
  744.           directory of the menus in your QuickBBS menu area.  1-EDIT
  745.           uses the CONFIG.BBS file to determine the path to this
  746.           area.  After displaying all of the menus you'll have the
  747.           option of editing/adding a menu, renaming a menu, copying
  748.           a menu, deleting a menu, or relisting the files.
  749.  
  750.           There's no need to explain most of these functions.  One
  751.           thing you might like to know is that any rename, delete,
  752.           or copy operation can be stopped by pressing [ENTER] on a
  753.           blank input field.
  754.  
  755.           Choose the <E> option and you'll be prompted for the menu
  756.           filename to edit.  Input the name.  If the menu isn't
  757.           found, you'll be asked if you wish to create it.  After
  758.           entering the menu name, you'll be dropped onto the main
  759.           menu editor menu.  From here you can do a variety of
  760.           things, all very similar to the same functions in
  761.           Menuedit.
  762.  
  763.           Rather than beat a dead horse trying to detail each
  764.           section of this menu, you should just play with it a bit.
  765.           It's pretty easy.  Start by copying a menu, any menu, to
  766.           another menu file called, maybe, TEST or FRED or
  767.           something.  Then hack on that copied menu.  You'll get the
  768.           hang of it pretty quickly (like instantly, I hope).
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.           1-EDIT v1.01                                  Page 11
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.                    ┌───────────────────────────────────────┐
  802.                    │           THE USER EDITOR             │
  803.                    └───────────────────────────────────────┘
  804.  
  805.  
  806.  
  807.           Most all of this section should be pretty easy to figure
  808.           also.  For the most part, everything is self-explanatory.
  809.           Press the plus key (+) for the next user or the minus key
  810.           (-) for the previous user.  When moving from user to user,
  811.           if you hit the beginning or end of the USERS.BBS file, the
  812.           program will "wrap around" for the next user.  Example:
  813.           You come to the last user in the file, say user #100, then
  814.           press the plus key (+).  1-EDIT will "wrap around" to user
  815.           #0.
  816.  
  817.           Pick and choose the fields you need to edit, press the
  818.           bracketed key <>, and you edit to your heart's content.
  819.           One note of interest: Should you go to edit a field and
  820.           then decide not to change anything, just press [ENTER] and
  821.           that field will remain unchanged.
  822.  
  823.           NOTE: It's impossible to edit your own user file while
  824.           shelled out from QuickBBS.  This is not a bug in 1-Edit;
  825.           rather, it's a feature (sort of) of QuickBBS.  When you
  826.           log-off of QuickBBS, it updates your entire user record --
  827.           completely overwriting any edits you make.  This will
  828.           happen whether you edit with 1-Edit, Useredit, Qufe, etc.
  829.           To edit your own record, you must log-on to QuickBBS under
  830.           another name -- maybe "Joe User" or somesuch -- and then
  831.           do the editing to your "real" record.
  832.  
  833.           At the bottom of the screen, you'll see a small window
  834.           with choices to add a user, delete a user, toggle NO-KILL
  835.           and other flags, etc.  <Q>uit takes you back to the main
  836.           menu.  <O>ther clears this small window and replaces it
  837.           with a different set of options that allow you to make
  838.           mass updates to flags or high message read numbers (see
  839.           below), and to edit some of the other user fields that
  840.           aren't often edited.  To return to the first set of
  841.           options, press <O> again.
  842.  
  843.  
  844.           MASS UPDATES
  845.  
  846.           From the <O>ther window, you have the ability to do mass
  847.           updates to flags and high message read numbers.  What's
  848.           this good for?  Well, a couple of things:
  849.  
  850.           Some of you use a combination auto-executed menu options
  851.           and flags to show your BBS users a news file.  After they
  852.           1-EDIT v1.01                                  Page 12
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.           read the file, you set that flag to OFF.  When you create
  868.           a new news file, you must go back and turned everyone's
  869.           flag back on again.  Mass Flag Upd. allows you to do that.
  870.           You're asked for the flag you wish to set (A, B, C, or D),
  871.           the flag position to set (1-8), and whether you want it on
  872.           or off.  After entering the information, 1-EDIT will go
  873.           through and reset that flag bit for each user in the
  874.           USERS.BBS.
  875.  
  876.           Mass updating of high message read is usually good after
  877.           you either bomb your message base, or do a slightly messed
  878.           up message renumber.  I've had a few occasions where my
  879.           message base has gotten destroyed and I've had to delete
  880.           all the files.  After doing so, all the user records still
  881.           contain the old high message read numbers, so the users
  882.           all get the "No new messages" line when they attempt to
  883.           read new messages.  Using this mass update option lets you
  884.           reset everybody's high read number back to 0 (or whatever
  885.           number you want).
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.           1-EDIT v1.01                                  Page 13
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.                    ┌───────────────────────────────────────┐
  934.                    │          REGISTERING 1-EDIT           │
  935.                    └───────────────────────────────────────┘
  936.  
  937.  
  938.  
  939.           KEYS
  940.  
  941.           1-EDIT uses a "keyed" registration system similar to that
  942.           used by QuickBBS.  The information used to create your key
  943.           is your system name and sysop name as contained in your
  944.           CONFIG.BBS file.  Unregistered versions of the program
  945.           (programs running without the key) have a 4 second pause
  946.           built in at the beginning of the program, plus the status
  947.           line is disabled.  Registered versions will also show the
  948.           registered system name and sysop name during the opening
  949.           screen (i.e. "Registered to: Creative Connection  Bob
  950.           Ransom").  These are the only differences between
  951.           registered and unregistered copies.  1-EDIT has no built
  952.           in self-destruct mechanisms or other disgusting things.
  953.  
  954.           When you register 1-EDIT, you'll receive a small key file
  955.           that will disable the bell ring and pause, and enable the
  956.           status line.  If you hold a valid Fidonet node number,
  957.           your key file will be sent to you through netmail file
  958.           attach.  Sysops who aren't a part of Fidonet or who are
  959.           outside of the continental U.S. and Canada will receive
  960.           their key files on a disk through the mail.
  961.  
  962.  
  963.           INSTALLING KEYS
  964.  
  965.           When you receive your key file, it will be named something
  966.           like LASTNAME.KEY (where LASTNAME is your last name).
  967.           Place this key file into your main QuickBBS (where 1-EDIT
  968.           will be running from) and rename it 1EDIT.KEY.  Be sure to
  969.           check your spelling here: "1-EDIT.KEY" won't work; only
  970.           "1EDIT.KEY" will.
  971.  
  972.           Leave this key in place for as long as you use 1-EDIT.  It
  973.           will be good for all future releases of the program.  If
  974.           for some reason I should need to make a change in the key
  975.           encryption routines (which would invalidate your key), a
  976.           new key will be sent to you immediately.
  977.  
  978.           REGISTERING
  979.  
  980.           A registration form called REGISTER.DOC is included in the
  981.           1-EDIT archive.  Please complete this form and mail it
  982.           with your check or money order for $10 (U.S. funds) to the
  983.           address on that form.  You key will be sent to you within
  984.           1-EDIT v1.01                                  Page 14
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.           a few days of receipt of your check.
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.                    ┌───────────────────────────────────────┐
  1006.                    │              BETA SITES               │
  1007.                    └───────────────────────────────────────┘
  1008.  
  1009.  
  1010.  
  1011.           The following are the sysops and systems where 1-EDIT was
  1012.           beta tested:
  1013.  
  1014.           SYSTEM          SYSOP              PHONE         FIDONET
  1015.  
  1016.           Revelstone      Barron Featherston 313/542-4043  1:120/210
  1017.           Holiday Magic   Bob Holiday        313/552-8605  1:120/125
  1018.           BillsBoard      Bill Chambers      512/447-9248   n/a
  1019.           Atlantis        Chris Lamprecht    512/836-8777  1:382/36
  1020.           Middle Earth    Jim Roe            512/835-4848  1:382/19
  1021.           JimNet          Jim Westbrook      512/837-0953  1:382/29
  1022.           Lounge Lizard's
  1023.              Retreat      George Vandervort  512/357-6904  1:382/8
  1024.           City Terminal   John Parlin        612/938-4301  1:282/12
  1025.  
  1026.           More likely than not, you should be able to find the most
  1027.           current version of 1-EDIT on one of these systems.
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.           1-EDIT v1.01                                  Page 15
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.                    ┌───────────────────────────────────────┐
  1066.                    │               THE END                 │
  1067.                    └───────────────────────────────────────┘
  1068.  
  1069.  
  1070.  
  1071.           Okay, I guess that wraps it up.  Hopefully this document
  1072.           is complete enough that you can set up and run 1-EDIT
  1073.           without problems.  Should you encounter a problem of some
  1074.           kind or an unfound bug, please be sure to let me know.
  1075.           Suggestions for enhancements are always welcomed, too.
  1076.           You can contact me through the main QuickBBS Support echo,
  1077.           through the QuickPro echo, through the Quick_Beta echo, or
  1078.           by netmail.
  1079.  
  1080.           The current version of this program is available for file
  1081.           request from my system under the magic name of 1EDIT.
  1082.           First time callers can also download the program from the
  1083.           QuickBBS Files section.
  1084.  
  1085.           -Bob Ransom
  1086.            27840 Lathrup Blvd.
  1087.            Lathrup Village, MI  48076
  1088.  
  1089.            The Creative Connection BBS
  1090.            24 hours / 7 days
  1091.            300-1200-2400 Baud / 8-N-1
  1092.            313/559-9039
  1093.            1:120/96
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.           1-EDIT v1.01                                  Page 16
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.